home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / ainfo.z / ainfo
Text File  |  1998-10-30  |  34KB  |  595 lines
  1.  
  2.  
  3.  
  4. aaaaiiiinnnnffffoooo((((1111))))                                                              aaaaiiiinnnnffffoooo((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ainfo - display array information
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      aaaaiiiinnnnffffoooo [_o_p_t_i_o_n_s...] _r_e_q_u_e_s_t
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _a_i_n_f_o command is used to display various information about arrays
  16.      known to the array services daemon.  This information could be useful for
  17.      both interactive users and shell scripts, and can be displayed in formats
  18.      appropriate for either.  The type of information displayed is determined
  19.      by the rrrreeeeqqqquuuueeeesssstttt argument which is described below.
  20.  
  21.      Many of the options are used to narrow down a request or to specify a
  22.      particular element to be described.  Not all of the options make sense
  23.      for every request.  Options that are not used by a particular request
  24.      will be ignored silently.  The valid options include:
  25.  
  26.      _----_aaaa _a_r_r_a_y_n_a_m_e or _----_aaaa_rrrr_rrrr_aaaa_yyyy _a_r_r_a_y_n_a_m_e
  27.           Specifies the name of a specific array about which information is
  28.           required.  If not specified, the array services daemon's default
  29.           destination will be used.
  30.  
  31.      _----_bbbb or _----_bbbb_rrrr_iiii_eeee_ffff
  32.           Brief: specifies brief output, intended for use by shell scripts.
  33.           This is the same as specifying "-f 2".
  34.  
  35.      _----_DDDD or _----_dddd_iiii_rrrr_eeee_cccc_tttt
  36.           When used with _----_ssss, indicates that the request should be sent
  37.           directly to the specified server, rather than forwarded to that
  38.           server by the local array services daemon.  This will fail on
  39.           systems that use array services authentication unless the ----KKKKllll and
  40.           ----KKKKrrrr options are also specified.  _----_DDDD is the default behavior under
  41.           normal circumstances (but see the description of the _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______FFFF_OOOO_RRRR_WWWW_AAAA_RRRR_DDDD
  42.           variable, below).
  43.  
  44.      _----_FFFF or _----_ffff_oooo_rrrr_wwww_aaaa_rrrr_dddd
  45.           When used with _----_ssss, indicates that the request should be forwarded to
  46.           the specified server via the local array services daemon, rather
  47.           than sent directly to it.  _----_FFFF will become the default behavior if
  48.           the value of the _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______FFFF_OOOO_RRRR_WWWW_AAAA_RRRR_DDDD environment variable begins with the
  49.           letter "Y" (as in "yes"; it may be either upper or lower case).
  50.  
  51.      _----_ffff _n_u_m_b_e_r or _----_ffff_oooo_rrrr_mmmm_aaaa_tttt _n_u_m_b_e_r
  52.           Format: many requests can display their information in several
  53.           formats.  This option is used to select which format is to be used.
  54.           See the descriptions of the individual requests to see which formats
  55.           are available for each.  The default format is always "1", which is
  56.           typically appropriate for a human user.  The other formats are
  57.           usually intended for use by shell scripts.  The output generated by
  58.           format 1 for a given request may change from version to version of
  59.           _a_i_n_f_o as new fields are added or modified.  However, unless
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaaiiiinnnnffffoooo((((1111))))                                                              aaaaiiiinnnnffffoooo((((1111))))
  71.  
  72.  
  73.  
  74.           otherwise specified, the output generated by the other formats
  75.           generally should _n_o_t change in future versions of _a_i_n_f_o, so that old
  76.           scripts will still run properly.  Instead, new formats will be added
  77.           to handle the new or modified fields.
  78.  
  79.      _----_hhhh _A_S_H or _----_aaaa_ssss_hhhh _A_S_H or _----_aaaa_rrrr_ssss_eeee_ssss_ssss _A_S_H
  80.           Specifies a particular array session handle about which information
  81.           is required.
  82.  
  83.      _----_iiii _P_I_D or _----_pppp_iiii_dddd _P_I_D or _----_pppp_rrrr_oooo_cccc_eeee_ssss_ssss _P_I_D
  84.           Specifies a particular process ID about which information is
  85.           required.
  86.  
  87.      _----_KKKK_llll _k_e_y or _----_llll_oooo_cccc_aaaa_llll_kkkk_eeee_yyyy _k_e_y
  88.           Use _k_e_y for the local authentication key when communicating directly
  89.           with a remote array services daemon.  _k_e_y is an unsigned 64-bit
  90.           value.  The default local key is obtained from the environment
  91.           variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______LLLL_OOOO_CCCC_AAAA_LLLL_KKKK_EEEE_YYYY; if that does not exist, no key is used.
  92.           The actual role played by _k_e_y depends on the authentication method
  93.           used by array services in a particular configuration.  In general,
  94.           it is not used when communicating with an array services daemon on
  95.           the local machine.
  96.  
  97.      _----_KKKK_rrrr _k_e_y or _----_rrrr_eeee_mmmm_oooo_tttt_eeee_kkkk_eeee_yyyy _k_e_y
  98.           Use _k_e_y for the remote authentication key when communicating
  99.           directly with a remote array services daemon.  _k_e_y is an unsigned
  100.           64-bit value.  The default remote key is obtained from the
  101.           environment variable _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______RRRR_EEEE_MMMM_OOOO_TTTT_EEEE_KKKK_EEEE_YYYY; if that does not exist, no
  102.           key is used.  The actual role played by _k_e_y depends on the
  103.           authentication method used by array services in a particular
  104.           configuration.  In general, it is not used when communicating with
  105.           an array services daemon on the local machine.
  106.  
  107.      _----_llll or _----_llll_oooo_cccc_aaaa_llll
  108.           Local: several requests normally display information about several
  109.           different machines in an array.  This option indicates that only
  110.           information about the machine running the array services daemon
  111.           (typically the local machine) should be displayed.  Requests that
  112.           use the ----aaaa option will generally ignore it if ----llll is specified.
  113.  
  114.      _----_pppp _p_o_r_t or _----_pppp_oooo_rrrr_tttt _p_o_r_t
  115.           Specifies the port address of the array services daemon.  Defaults
  116.           to the value of the _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD______PPPP_OOOO_RRRR_TTTT environment variable if present, or
  117.           the standard port number of the "sgi-arrayd" service otherwise.
  118.  
  119.      _----_ssss _s_e_r_v_e_r or _----_ssss_eeee_rrrr_vvvv_eeee_rrrr _s_e_r_v_e_r
  120.           Specifies the hostname or IP address of the array services daemon.
  121.           Defaults to the value of the _AAAA_RRRR_RRRR_AAAA_YYYY_DDDD environment variable if present,
  122.           or "localhost" otherwise.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaaiiiinnnnffffoooo((((1111))))                                                              aaaaiiiinnnnffffoooo((((1111))))
  137.  
  138.  
  139.  
  140.      _----_tttt _v_a_l_u_e or _----_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt _v_a_l_u_e
  141.           Specifies the timeout value (in seconds) used in waiting for a
  142.           response from the array services daemon.  The default is 15 seconds.
  143.           It should only be necessary to specify this option on very heavily
  144.           loaded systems.
  145.  
  146.      _----_vvvv   Verbose messages: display additional progress messages.  Repeated
  147.           occurrences (either "-v -v ..." or "-vv...") increases the
  148.           verbosity, although this is generally only useful for debugging
  149.           _a_i_n_f_o itself.
  150.  
  151. RRRREEEEQQQQUUUUEEEESSSSTTTTSSSS
  152.      Several different types of information can be requested.  In most cases,
  153.      each type of information can be displayed in several formats.  The
  154.      keyword used to specify a particular request may be in upper or lower
  155.      case, and for some requests, it may only be necessary to specify a
  156.      leading substring of the keyword.  The following descriptions will show
  157.      the minimum leading substring of each keyword in upper case.
  158.  
  159.    AAAARRRRRRRRAAAAYYYYssss
  160.      Displays information about all arrays known to the array services daemon.
  161.      The ----aaaa, ----hhhh, ----iiii and ----llll options are all ignored with this request.
  162.  
  163.      Format 1 output:
  164.           _AAAA_rrrr_rrrr_aaaa_yyyy_ssss _kkkk_nnnn_oooo_wwww_nnnn _tttt_oooo _aaaa_rrrr_rrrr_aaaa_yyyy _ssss_eeee_rrrr_vvvv_iiii_cccc_eeee_ssss _dddd_aaaa_eeee_mmmm_oooo_nnnn _t_a_r_g_e_t-_i_n_f_o
  165.           _AAAA_RRRR_RRRR_AAAA_YYYY _n_a_m_e
  166.               _IIII_DDDD_EEEE_NNNN_TTTT _i_d
  167.               ATTRIBUTES
  168.                   _a_r_r_a_y__a_t_t_r__1
  169.                   _a_r_r_a_y__a_t_t_r__2...
  170.  
  171.           ARRAY ...
  172.  
  173.           If the ----pppp or ----ssss options were specified, that information will be
  174.           included in _t_a_r_g_e_t-_i_n_f_o.  _n_a_m_e is the ASCII name of the array, as
  175.           specified in the _a_r_r_a_y_d._c_o_n_f file.  _i_d is the array identifier
  176.           number, as specified in the _a_r_r_a_y_d._c_o_n_f file with an ARRAY IDENT
  177.           statement.  It is always printed as a 4-digit hexadecimal preceded
  178.           by "0x".  The _a_r_r_a_y__a_t_t_r__N values are arbitrary strings assigned to
  179.           the array by the system administrator.  If no array attributes are
  180.           present, the "ATTRIBUTES" line will not be printed.
  181.  
  182.      Format 2 output:
  183.           _aaaa_rrrr_rrrr_aaaa_yyyy _n_a_m_e #_a_t_t_r_i_b_u_t_e_s _a_r_r_a_y__a_t_t_r__1 _a_r_r_a_y__a_t_t_r__2...
  184.  
  185.      Format 3 output:
  186.           _aaaa_rrrr_rrrr_aaaa_yyyy _n_a_m_e _i_d #_a_t_t_r_i_b_u_t_e_s _a_r_r_a_y__a_t_t_r__1 _a_r_r_a_y__a_t_t_r__2...
  187.  
  188.           This is the same as format 2, with the addition of the _i_d field.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. aaaaiiiinnnnffffoooo((((1111))))                                                              aaaaiiiinnnnffffoooo((((1111))))
  203.  
  204.  
  205.  
  206.    AAAASSSSHHHH
  207.      Displays the array session handle of the process specified by the ----iiii
  208.      option.  If the ----iiii option is not specified, then the array session handle
  209.      for the current process will be displayed.  The process is assumed to
  210.      reside _o_n _t_h_e _l_o_c_a_l _m_a_c_h_i_n_e.  The ----aaaa, ----hhhh and ----llll options are ignored.
  211.  
  212.      Format 1 output:
  213.           _AAAA_rrrr_rrrr_aaaa_yyyy _ssss_eeee_ssss_ssss_iiii_oooo_nnnn _hhhh_aaaa_nnnn_dddd_llll_eeee _oooo_ffff _pppp_rrrr_oooo_cccc_eeee_ssss_ssss _p_i_d_:::: _a_s_h
  214.  
  215.           _p_i_d is the process ID specified by the ----iiii option.  _a_s_h is the array
  216.           session handle of process _p_i_d.  It is displayed in hex preceded by
  217.           the string "0x".
  218.  
  219.      Format 2 output:
  220.           _p_i_d
  221.  
  222.    DDDDFFFFLLLLTTTTAAAArrrrrrrraaaayyyy
  223.      Displays information about the default array that is used by the array
  224.      services daemon when one has not been specified explicitly.  The ----aaaa, ----hhhh,
  225.      ----iiii and ----llll options are ignored.  The format of the output is nearly
  226.      identical to that of the ARRAYS request:
  227.  
  228.      Format 1 output:
  229.           _DDDD_eeee_ffff_aaaa_uuuu_llll_tttt _aaaa_rrrr_rrrr_aaaa_yyyy _aaaa_cccc_cccc_oooo_rrrr_dddd_iiii_nnnn_gggg _tttt_oooo _aaaa_rrrr_rrrr_aaaa_yyyy _ssss_eeee_rrrr_vvvv_iiii_cccc_eeee_ssss _dddd_aaaa_eeee_mmmm_oooo_nnnn _t_a_r_g_e_t-_i_n_f_o
  230.           _AAAA_RRRR_RRRR_AAAA_YYYY _n_a_m_e
  231.               _AAAA_TTTT_TTTT_RRRR_IIII_BBBB_UUUU_TTTT_EEEE_SSSS
  232.                   _a_r_r_a_y__a_t_t_r__1
  233.                   _a_r_r_a_y__a_t_t_r__2_...._...._....
  234.  
  235.           If the ----pppp or ----ssss options were specified, that information will be
  236.           included in _t_a_r_g_e_t-_i_n_f_o.  _n_a_m_e is the ASCII name of the array, as
  237.           specified in the _a_r_r_a_y_d._c_o_n_f file.  The _a_r_r_a_y__a_t_t_r__N values are
  238.           arbitrary strings assigned to the array by the system administrator.
  239.           If no array attributes are present, the "ATTRIBUTES" line will not
  240.           be printed.
  241.  
  242.      Format 2 output:
  243.           _aaaa_rrrr_rrrr_aaaa_yyyy _n_a_m_e #_a_t_t_r_i_b_u_t_e_s _a_r_r_a_y__a_t_t_r__1 _a_r_r_a_y__a_t_t_r__2...
  244.  
  245.    MMMMAAAACCCCHHHHiiiinnnneeeessss
  246.      Displays information about each of the machines in the array specified by
  247.      the ----aaaa option.  The ----hhhh, ----iiii and ----llll options are ignored.
  248.  
  249.      Format 1 output:
  250.           _MMMM_aaaa_cccc_hhhh_iiii_nnnn_eeee_ssss _iiii_nnnn _a_r_r_a_y-_n_a_m_e _t_a_r_g_e_t-_i_n_f_o
  251.           _MMMM_AAAA_CCCC_HHHH_IIII_NNNN_EEEE _n_a_m_e
  252.               _HHHH_OOOO_SSSS_TTTT_NNNN_AAAA_MMMM_EEEE _h_o_s_t_n_a_m_e
  253.               _PPPP_OOOO_RRRR_TTTT     _p_o_r_t_n_u_m
  254.               _IIII_PPPP______AAAA_DDDD_DDDD_RRRR  _I_P_a_d_d_r_e_s_s
  255.               _IIII_DDDD_EEEE_NNNN_TTTT    _i_d
  256.               _AAAA_TTTT_TTTT_RRRR_IIII_BBBB_UUUU_TTTT_EEEE_SSSS
  257.                   _a_t_t_r_1
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. aaaaiiiinnnnffffoooo((((1111))))                                                              aaaaiiiinnnnffffoooo((((1111))))
  269.  
  270.  
  271.  
  272.                   _a_t_t_r_2_...._...._....
  273.  
  274.           _MMMM_AAAA_CCCC_HHHH_IIII_NNNN_EEEE _...._...._....
  275.  
  276.           _t_a_r_g_e_t-_i_n_f_o includes information about the array services daemon
  277.           that was contacted and the particular array being described.  If the
  278.           ----aaaa, ----pppp or ----ssss options were specified, that information will be
  279.           included in _t_a_r_g_e_t-_i_n_f_o.  _n_a_m_e is the "familiar" name of the
  280.           machine, while _h_o_s_t_n_a_m_e is the official network hostname of the
  281.           machine and _I_P_a_d_d_r_e_s_s is the network address corresponding to that
  282.           hostname.  _p_o_r_t_n_u_m is the port number of the machine's array
  283.           services daemon.  _i_d is the server identifier of the machine's array
  284.           services daemon.  It is always printed as a 4-digit hexadecimal
  285.           number preceded by "0x" unless the array services daemon specified
  286.           in _t_a_r_g_e_t-_i_n_f_o does not have a _SSSS_EEEE_RRRR_VVVV_EEEE_RRRR _IIII_DDDD_EEEE_NNNN_TTTT entry for that machine,
  287.           in which case "unknown" is printed.  The _a_t_t_r_N values are arbitrary
  288.           strings assigned to this machine by the system administrator.  If a
  289.           particular machine has no machine attributes, the _AAAA_TTTT_TTTT_RRRR_IIII_BBBB_UUUU_TTTT_EEEE_SSSS line
  290.           will not be displayed.
  291.  
  292.      Format 2 output:
  293.           _mmmm_aaaa_cccc_hhhh_iiii_nnnn_eeee _n_a_m_e _h_o_s_t_n_a_m_e _p_o_r_t_n_u_m _I_P_a_d_d_r_e_s_s #_a_t_t_r_s _a_t_t_r_1 _a_t_t_r_2_...._...._....
  294.  
  295.           The output for each machine will appear on a single line without any
  296.           intervening newlines.
  297.  
  298.      Format 3 output:
  299.           _h_o_s_t_n_a_m_e
  300.           _h_o_s_t_n_a_m_e_...._...._....
  301.  
  302.           This format would be useful in scripts that need to contact each
  303.           machine in an array via the network.
  304.  
  305.      Format 4 output:
  306.           _mmmm_aaaa_cccc_hhhh_iiii_nnnn_eeee _n_a_m_e _h_o_s_t_n_a_m_e _p_o_r_t_n_u_m _I_P_a_d_d_r_e_s_s _i_d #_a_t_t_r_s _a_t_t_r_1 _a_t_t_r_2...
  307.  
  308.           This is the same as format 2, with the addition of the _i_d_e_n_t value
  309.           just prior to the attributes.  The output for each machine will
  310.           appear on a single line without any intervening newlines.
  311.  
  312.    NNNNEEEEWWWWAAAASSSSHHHH
  313.      Obtains a new global array session handle for the array specified by the
  314.      ----aaaa option.  This does not actually start a new array session, it simply
  315.      allocates a unique handle for one.  The ----hhhh, ----iiii and ----llll options are all
  316.      ignored.
  317.  
  318.      Format 1 output:
  319.           _AAAA_llll_llll_oooo_cccc_aaaa_tttt_iiii_nnnn_gggg _nnnn_eeee_wwww _gggg_llll_oooo_bbbb_aaaa_llll _AAAA_SSSS_HHHH _t_a_r_g_e_t-_i_n_f_o
  320.           _a_r_r_a_y-_s_e_s_s_i_o_n-_h_a_n_d_l_e
  321.  
  322.           _t_a_r_g_e_t-_i_n_f_o includes information about the array services daemon
  323.           that was contacted and the particular array for which the handle was
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. aaaaiiiinnnnffffoooo((((1111))))                                                              aaaaiiiinnnnffffoooo((((1111))))
  335.  
  336.  
  337.  
  338.           allocated.  If the ----aaaa, ----pppp or ----ssss options were specified, that
  339.           information will be included in _t_a_r_g_e_t-_i_n_f_o.  The _a_r_r_a_y-_s_e_s_s_i_o_n-
  340.           _h_a_n_d_l_e is displayed as a 64-bit hex value preceded by the string
  341.           "0x".
  342.  
  343.      Format 2 output:
  344.           _a_r_r_a_y-_s_e_s_s_i_o_n-_h_a_n_d_l_e
  345.  
  346.           The _a_r_r_a_y-_s_e_s_s_i_o_n-_h_a_n_d_l_e is displayed as a 64-bit hex value preceded
  347.           by the string "0x".
  348.  
  349.    NNNNOOOODDDDEEEEIIIINNNNFFFFOOOO
  350.      Displays information about the overall configuration of each machine in
  351.      the array specified by the ----aaaa option, or of the server machine only if
  352.      the ----llll option was specified.  The ----hhhh and ----iiii options are ignored.
  353.  
  354.      Format 1 output:
  355.           _NNNN_oooo_dddd_eeee _iiii_nnnn_ffff_oooo_rrrr_mmmm_aaaa_tttt_iiii_oooo_nnnn _ffff_oooo_rrrr _t_a_r_g_e_t-_i_n_f_o
  356.           _MMMM_AAAA_CCCC_HHHH_IIII_NNNN_EEEE _n_a_m_e
  357.               _VVVV_EEEE_RRRR_SSSS_IIII_OOOO_NNNN  _v_e_r_s
  358.               #_p_e _PPPP_RRRR_OOOO_CCCC_EEEE_SSSS_SSSS_OOOO_RRRR _BBBB_OOOO_AAAA_RRRR_DDDD[_SSSS]
  359.                   _BBBB_OOOO_AAAA_RRRR_DDDD_:::: _TTTT_YYYY_PPPP_EEEE _b_t_y_p_e   _SSSS_PPPP_EEEE_EEEE_DDDD _s_p_e_e_d
  360.                       _CCCC_PPPP_UUUU_::::   _TTTT_YYYY_PPPP_EEEE _c_t_y_p_e   _RRRR_EEEE_VVVV_IIII_SSSS_IIII_OOOO_NNNN _c_r_e_v
  361.                       _FFFF_PPPP_UUUU_::::   _TTTT_YYYY_PPPP_EEEE _f_t_y_p_e   _RRRR_EEEE_VVVV_IIII_SSSS_IIII_OOOO_NNNN _f_r_e_v
  362.  
  363.                   _BBBB_OOOO_AAAA_RRRR_DDDD_...._...._....
  364.  
  365.               #_i_p _IIII_PPPP _IIII_NNNN_TTTT_EEEE_RRRR_FFFF_AAAA_CCCC_EEEE[_SSSS]  _HHHH_OOOO_SSSS_TTTT_NNNN_AAAA_MMMM_EEEE _h_o_s_t_n_a_m_e   _HHHH_OOOO_SSSS_TTTT_IIII_DDDD _h_o_s_t_i_d
  366.                   _DDDD_EEEE_VVVV_IIII_CCCC_EEEE _d_e_v  _NNNN_EEEE_TTTT_WWWW_OOOO_RRRR_KKKK _n_e_t_a_d_d_r  _AAAA_DDDD_DDDD_RRRR_EEEE_SSSS_SSSS _i_p_a_d_d_r _s_t_a_t_u_s
  367.                   _DDDD_EEEE_VVVV_IIII_CCCC_EEEE_...._...._....
  368.  
  369.               #_g_f_x _GGGG_RRRR_AAAA_PPPP_HHHH_IIII_CCCC_SSSS _IIII_NNNN_TTTT_EEEE_RRRR_FFFF_AAAA_CCCC_EEEE[_SSSS]
  370.                   _TTTT_YYYY_PPPP_EEEE _g_t_y_p_e  _CCCC_TTTT_RRRR_LLLL_RRRR _c_t_r_l_r  _UUUU_NNNN_IIII_TTTT _u_n_i_t  _SSSS_TTTT_AAAA_TTTT_EEEE _s_t_a_t_e
  371.                   _TTTT_YYYY_PPPP_EEEE_...._...._....
  372.  
  373.               _MMMM_EEEE_MMMM_OOOO_RRRR_YYYY
  374.                   _m_e_m_s_i_z_e _MMMM_BBBB _MMMM_AAAA_IIII_NNNN _MMMM_EEEE_MMMM_OOOO_RRRR_YYYY
  375.                   _IIII_NNNN_TTTT_EEEE_RRRR_LLLL_EEEE_AAAA_VVVV_EEEE _i_n_t_e_r_l_e_a_v_e
  376.  
  377.               _AAAA_RRRR_RRRR_AAAA_YYYY _MMMM_AAAA_CCCC_HHHH_IIII_NNNN_EEEE _a_r_r_a_y_m_a_c_h
  378.                   _AAAA_RRRR_RRRR_AAAA_YYYY _SSSS_EEEE_RRRR_VVVV_IIII_CCCC_EEEE_SSSS _PPPP_OOOO_RRRR_TTTT _p_o_r_t
  379.                   #_a_t_t_r _AAAA_TTTT_TTTT_RRRR_IIII_BBBB_UUUU_TTTT_EEEE_SSSS
  380.                           _a_t_t_r
  381.                           _a_t_t_r_...._...._....
  382.  
  383.           _MMMM_AAAA_CCCC_HHHH_IIII_NNNN_EEEE _...._...._....
  384.  
  385.           _t_a_r_g_e_t-_i_n_f_o includes information about the array services daemon
  386.           that was contacted and the particular machine or array being
  387.           described.  If the ----aaaa, ----pppp or ----ssss options were specified, that
  388.           information will be included in _t_a_r_g_e_t-_i_n_f_o.  _n_a_m_e is the hostname
  389.           of the machine according to the machine's array services daemon.
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. aaaaiiiinnnnffffoooo((((1111))))                                                              aaaaiiiinnnnffffoooo((((1111))))
  401.  
  402.  
  403.  
  404.           This is typically the value returned by _g_e_t_h_o_s_t_n_a_m_e(2) on that
  405.           machine, though the system adminstrator can override this value by
  406.           specifying a LLLLOOOOCCCCAAAALLLL HHHHOOOOSSSSTTTTNNNNAAAAMMMMEEEE entry in the machine's arrayd.conf file.
  407.           _v_e_r_s is the NodeInfo version number.  This will change whenever the
  408.           output format is modified in some way.  The minor number of the
  409.           version is rolled when additional fields are added to the end of any
  410.           line or section.  The major number is rolled if previously existing
  411.           fields are changed.  Programs that parse the output of _a_i_n_f_o should
  412.           inspect this value and act accordingly if it does not recognize the
  413.           version number.
  414.  
  415.           The fields in the _PPPP_RRRR_OOOO_CCCC_EEEE_SSSS_SSSS_OOOO_RRRR _BBBB_OOOO_AAAA_RRRR_DDDD and _GGGG_RRRR_AAAA_PPPP_HHHH_IIII_CCCC_SSSS _IIII_NNNN_TTTT_EEEE_RRRR_FFFF_AAAA_CCCC_EEEE sections
  416.           are taken directly from the iiiinnnnvvvveeeennnnttttoooorrrryyyy____tttt structures returned by
  417.           _g_e_t_i_n_v_e_n_t(3).  These are described in <sys/invent.h>.
  418.  
  419.           _h_o_s_t_n_a_m_e is the hostname of the machine's primary network interface
  420.           as determined by _g_e_t_h_o_s_t_n_a_m_e(2).  This is typically the same as _n_a_m_e
  421.           unless a different machine name was specified with a LLLLOOOOCCCCAAAALLLL HHHHOOOOSSSSTTTTNNNNAAAAMMMMEEEE
  422.           entry in the machine's arrayd.conf file.  _h_o_s_t_i_d is the machine's
  423.           official hostid, as obtained by _g_e_t_h_o_s_t_i_d(2).  It is displayed as a
  424.           hex value.  _d_e_v is the device name of a particular network interface
  425.           (for example, "hip0").  _n_e_t is the network address of the interface;
  426.           this is generally the IP address of the interface AND'ed with the
  427.           interface's netmask.  _i_p is the official IP address of the
  428.           interface.  _s_t_a_t_u_s is either the string "UP" or "DOWN", indicating
  429.           whether or not the interface is active.
  430.  
  431.           The ARRAY MACHINE section is only displayed when the ----llll has _n_o_t been
  432.           specified.  _a_r_r_a_y_m_a_c_h is the "logical" name of the machine in the
  433.           array.  In most cases this will be the same as the machine's
  434.           hostname, though the system administrator can override this in the
  435.           machine's arrayd.conf file.  _p_o_r_t is the IP port number of the array
  436.           services daemon on that machine.  _a_t_t_r is an attribute string for
  437.           that machine.  There may be zero or more of these, depending on the
  438.           configuration.
  439.  
  440.           The remaining fields are fairly self explanatory.
  441.  
  442.      Format 2 output:
  443.           _nnnn_oooo_dddd_eeee_iiii_nnnn_ffff_oooo_...._tttt_oooo_pppp _v_e_r_s _n_a_m_e
  444.           _nnnn_oooo_dddd_eeee_iiii_nnnn_ffff_oooo_...._pppp_eeee #_p_e _b_t_y_p_e_////_s_p_e_e_d_////_c_t_y_p_e_////_c_r_e_v_////_f_t_y_p_e_////_f_r_e_v _b_t_y_p_e_////...
  445.           _nnnn_oooo_dddd_eeee_iiii_nnnn_ffff_oooo_...._iiii_pppp _h_o_s_t_n_a_m_e _h_o_s_t_i_d #_i_p _d_e_v_////_n_e_t_a_d_d_r_////_i_p_a_d_d_r_////_s_t_a_t_u_s _d_e_v_////...
  446.           _nnnn_oooo_dddd_eeee_iiii_nnnn_ffff_oooo_...._gggg_ffff_xxxx #_g_f_x _g_t_y_p_e_////_c_t_r_l_r_////_u_n_i_t_////_s_t_a_t_e _g_t_y_p_e_////...
  447.           _nnnn_oooo_dddd_eeee_iiii_nnnn_ffff_oooo_...._mmmm_eeee_mmmm _m_e_m_s_i_z_e _i_n_t_e_r_l_e_a_v_e
  448.           _nnnn_oooo_dddd_eeee_iiii_nnnn_ffff_oooo_...._aaaa_mmmm _a_r_r_a_y_m_a_c_h _p_o_r_t #_a_t_t_r_s _a_t_t_r _a_t_t_r...
  449.  
  450.           The fields of individual interface entries (for example, between the
  451.           _t_y_p_e, _c_t_r_l_r, _u_n_i_t and _s_t_a_t_e fields of a graphics interface entry)
  452.           are separated by "/" characters with no intervening spaces.  Unlike
  453.           format 1, the array machine information will be present whether or
  454.           not ----llll was specified; if ----llll was specified, _a_r_r_a_y_m_a_c_h will be "<n/a>"
  455.           and _p_o_r_t will be -1.  The output for each machine will appear on
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. aaaaiiiinnnnffffoooo((((1111))))                                                              aaaaiiiinnnnffffoooo((((1111))))
  467.  
  468.  
  469.  
  470.           exactly 6 lines.
  471.  
  472.    PPPPIIIIDDDDssss
  473.      This is a synonym for the PROCESSES request, described below.
  474.  
  475.    PPPPRRRROOOOCCCCeeeesssssssseeeessss
  476.      Displays the process IDs of those processes _o_n _t_h_e _l_o_c_a_l _m_a_c_h_i_n_e running
  477.      in the array session whose handle is specified by the ----hhhh option.  The ----aaaa,
  478.      ----iiii and ----llll options are ignored for this request.
  479.  
  480.      Format 1 output:
  481.           _PPPP_rrrr_oooo_cccc_eeee_ssss_ssss _IIII_DDDD_ssss _iiii_nnnn _AAAA_SSSS_HHHH _a_r_r_a_y-_s_e_s_s_i_o_n-_h_a_n_d_l_e
  482.                   _p_r_o_c_e_s_s-_I_D
  483.                   _p_r_o_c_e_s_s-_I_D_...._...._....
  484.  
  485.      Format 2 output:
  486.           _p_r_o_c_e_s_s-_I_D _p_r_o_c_e_s_s-_I_D_...._...._....
  487.  
  488.           This format is convenient with commands such as _k_i_l_l(1).
  489.  
  490.      Format 3 output:
  491.           _p_r_o_c_e_s_s-_I_D,_p_r_o_c_e_s_s-_I_D,_...._...._....
  492.  
  493.           This format is convenient for use with the ----pppp option of the _p_s(1)
  494.           command.
  495.  
  496.    SSSSEEEESSSSSSSSIIIIOOOONNNNssss
  497.      Displays the array session handles of the global array sessions in the
  498.      array specified by the ----aaaa option, or only on the server machine if ----llll is
  499.      specified.  The ----hhhh and ----iiii options are ignored.
  500.  
  501.      Format 1 output:
  502.           _GGGG_llll_oooo_bbbb_aaaa_llll _aaaa_rrrr_rrrr_aaaa_yyyy _ssss_eeee_ssss_ssss_iiii_oooo_nnnn_ssss _t_a_r_g_e_t-_i_n_f_o
  503.                   _a_r_r_a_y-_s_e_s_s_i_o_n-_h_a_n_d_l_e-_1
  504.                   _a_r_r_a_y-_s_e_s_s_i_o_n-_h_a_n_d_l_e-_2_...._...._....
  505.  
  506.           _t_a_r_g_e_t-_i_n_f_o includes information about the array services daemon
  507.           that was contacted and the particular array being described.  If the
  508.           ----aaaa, ----pppp or ----ssss options were specified, that information will be
  509.           included in _t_a_r_g_e_t-_i_n_f_o.  Each _a_r_r_a_y-_s_e_s_s_i_o_n-_h_a_n_d_l_e is displayed as
  510.           a 64-bit hex value preceded by the string "0x".
  511.  
  512.      Format 2 output:
  513.           _a_r_r_a_y-_s_e_s_s_i_o_n-_h_a_n_d_l_e-_1 _a_r_r_a_y-_s_e_s_s_i_o_n-_h_a_n_d_l_e-_2...
  514.  
  515.           Each _a_r_r_a_y-_s_e_s_s_i_o_n-_h_a_n_d_l_e is displayed as a 64-bit hex value
  516.           preceded by the string "0x".
  517.  
  518. NNNNOOOOTTTTEEEESSSS
  519.      The array services daemon (_a_r_r_a_y_d(1M)) must be running on all machines
  520.      about which information is being obtained.  It does not necessarily have
  521.      to be running on the machine that executes "_a_i_n_f_o(1)".
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. aaaaiiiinnnnffffoooo((((1111))))                                                              aaaaiiiinnnnffffoooo((((1111))))
  533.  
  534.  
  535.  
  536. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  537.      array(1), arrayd(1M), arrayd.conf(4).
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.